home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / Converters / AMInd2DBmist.lha / AMInd2DB.doc next >
Encoding:
Text File  |  1995-07-27  |  7.3 KB  |  210 lines
  1.  
  2.                            --- AMInd2DB.doc ---
  3.  
  4. "AMInd2DB" is a short form for 'AmiNet Index to DataBase'.
  5.  
  6. This program converts the Aminet Index files (usually :AMINET/INDEX or
  7. :AMINET/INFO/INDEX/LOCAL for the wide version of the file on your AmiNet
  8. CD) to a file readable for the Import function of a database program like
  9. SuperBase or MaxonTwist.
  10.  
  11. To use it, simply call
  12.  
  13. AMInd2DB <Index-File >Output-File [Ident]
  14.  
  15. where the input and output streams are redirected (YES, these angle
  16. brackets have to be typed).
  17.  
  18. 'Ident' is optionally and adds a database field to the output if given.
  19. The contents is at your choice, but I intended this function to add a
  20. CD number field to every database record.
  21. This is handy if you plan to catalog your AmiNet CD's into a single huge
  22. database file. (This was the reason why this program is written)
  23.  
  24.  
  25. What you will get is an output like this:
  26.  
  27. "ABook_034.lha","biz/dbase","159K","8","A new address database using MUI (GIFTWA"
  28. "AFile_v401.lha","biz/dbase","123K","7","A datafile manager"
  29. "AmigaBase21.lha","biz/dbase","481K","6","Very powerful programmable database with"
  30. "AmigaBStamp.lha","biz/dbase","20K","4","Stamps exchange project, based on AmigaB"
  31. "AmigaWorld.lha","biz/dbase","596K","7","Database of information of all countries"
  32.  
  33. or this if you've started this program with an Identifier given:
  34.  
  35. "CD-6","ABook_034.lha","biz/dbase","159K","8","A new address database using MUI (GIFTWA"
  36. "CD-6","AFile_v401.lha","biz/dbase","123K","7","A datafile manager"
  37. "CD-6","AmigaBase21.lha","biz/dbase","481K","6","Very powerful programmable database with"
  38. "CD-6","AmigaBStamp.lha","biz/dbase","20K","4","Stamps exchange project, based on AmigaB"
  39. "CD-6","AmigaWorld.lha","biz/dbase","596K","7","Database of information of all countries"
  40.  
  41.  
  42. Ignoring the identifier, the leftmost field is the program name, following
  43. the directory where to find the program, the size, the age in weeks
  44. (relative to the date of the creation of the original list) and the short
  45. description.
  46.  
  47. To import the file into the database program, I suggest the following field
  48. definitions:
  49.  
  50. Ident        (as you wish)
  51. Name        TXT 19
  52. Directory    TXT 10
  53. Size        TXT 5
  54. Age        INT 4
  55. Description    TXT 42 (or TXT 100 if you plan to include the wide version)
  56.  
  57.  
  58.  
  59. "OK" you will think "There is another program doing the same task, where
  60. are the differences?"
  61.  
  62. Yes, there are differences:
  63.  
  64. 1) Trimmed database fields (no leading and trailing spaces)
  65.     Searching a database is easier because no leading or trailing
  66.     wildcards are needed to cover extra spaces.
  67.  
  68. 2) Fast! (at about 22 seconds parsing an 1MB index file on an A3000-25)
  69.  
  70. 3) Optionally including the identifier
  71.     Handy for the users creating Multi-CD data bases. Without this
  72.     option you have to import the file into an (existing) database,
  73.     using the update function to apply the CD number to the newly created
  74.     records and risking to give a already used number to the records
  75.     (mistyped a digit...).....
  76.  
  77. 4) Auto-detecting list field widths
  78.     Useful for these guys having AmiNet CD 3 and earlier together
  79.     with AmiNet CD 5 and up, because the width of the Name field varies
  80.     slightly, making other programs with fixed-width fields screw up.
  81.  
  82.  
  83.  
  84. BUGS
  85.  
  86. Huh? It works fine on my system. But PLEASE report me any bugs/quirks.
  87.  
  88.  
  89. CAVEATS
  90.  
  91. This program is designed to parse AmiNet Index files or similar.
  92. It is fixed to detect four contents fields with the length set by the
  93. header.
  94.  
  95. Unpredictable action may be taken if the program tries to parse an
  96. incorrect file.
  97.  
  98.  
  99. DISCLAIMER
  100.  
  101.    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  102. APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  103. HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  104. OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  105. THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  106. PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  107. PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
  108. COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  109.  
  110.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  111. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  112. PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  113. GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  114. USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
  115. OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
  116. THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  117. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  118. POSSIBILITY OF SUCH DAMAGES.
  119.  
  120.  
  121. To be short: It works on my machine. Don't know about yours.
  122.  
  123.  
  124. LEGAL ISSUES
  125.  
  126.  - This program is Cardware, that means, you can spread and use it as
  127.    you wish if not otherwise stated in the following terms:
  128.  
  129.  - If you use it regularly, drop me a postcard or an EMail. I just
  130.    want to know how much it is used...
  131.  
  132.  - The archive containing this program may be redistributed
  133.    via BBSes, on disks or other ways you can imagine (I want you to do
  134.    it!), but for REASONABLE media costs. ($5 for a disk are too much)
  135.  
  136.  - Inclusion in commercial programs requires the expressed written
  137.    consent by the author.
  138.  
  139.  - Spreading through PD series is allowed only if the price of the sold
  140.    media (mostly disks) doesn't exceed REASONABLE costs and/or the vendor
  141.    doesn't get any real income by selling it.
  142.  
  143.  - In this distribution no file has to be changed, omitted and/or added.
  144.    ! This includes the BBS ads most BBSes add to the archives passing
  145.    ! through. The SysOp is responsible for deleting these files
  146.    ! being automatically added.
  147.    But I want to be fair and I'm allowing one (1) BBS advertising
  148.    in this archive because really good BBS software has to be able to
  149.    delete alien BBS ads before adding the own.
  150.    If this happen to me to find an archive with more than one BBS
  151.    ad, the SysOps of the systems having added the second, third... ad
  152.    will be held liable for that.
  153.    THESE ARE NO EMPTY WORDS!
  154.    
  155.  - Executables must not be disassembled, resourced or re-enineered in
  156.    any other way imaginable. Furthermore, these must mot be patched,
  157.    either on the storage media, before starting or while running.
  158.  
  159.  
  160. HOW TO CONTACT ME
  161.  
  162. Comments, bug reports hello's, flames (huh?) to:
  163.  
  164.   sneaker@surprise.rhein-ruhr.de          (preferred)
  165.  
  166.  or
  167.  
  168.   Carsten_Pluntke@ouzonix.bo.open.de
  169.  
  170.  
  171. or post per snail mail, cookies, letterbombs, women :-), 68040-cards or
  172. just a postcard to:
  173.  
  174.   Carsten Pluntke
  175.   Buerer Str. 20
  176.   45899 Gelsenkirchen
  177.   Germany
  178.  
  179. Bank account for shareware payments or out-of-order money donations :-)
  180.  
  181.   Kto. 2686079
  182.   Stadtsparkasse Gladbeck
  183.   BLZ 424 500 40
  184.  
  185.  
  186. PGP-Users may be interested in my PGP public key:
  187.  
  188. -----BEGIN PGP PUBLIC KEY BLOCK-----
  189. Version: 2.3a.5
  190.  
  191. mQCNAi6oOe0AAAEEAM/locnCHkNMkfUOqVrgEphn0RzPiq2nu7I25eMrTR9OfsQQ
  192. 8RT/Y4xupkA4PvbS+9co9uAVPSreiI3uJhPc51k7q6RWJe4jqr2LSeIHSKB5S0RL
  193. 88k8J5ciMWEmIFyx9TW9EDKPnamwKZCHzq43WMGQ5XAbbMxwdizX/qpcziGxAAUR
  194. tDRDYXJzdGVuIFBsdW50a2UgPENhcnN0ZW5fUGx1bnRrZUBvdXpvbml4LmJvLm9w
  195. ZW4uZGU+tDBDYXJzdGVuIFBsdW50a2UgPHNuZWFrZXJAc3VycHJpc2UucmhlaW4t
  196. cnVoci5kZT60K0NhcnN0ZW4gUGx1bnRrZSA8Y2Fyc3RlbkBra2Iuc2V2ZW4uc3Vi
  197. Lm9yZz4=
  198. =RBZG
  199. -----END PGP PUBLIC KEY BLOCK-----
  200.  
  201. PGP fingerprint =  9B EB 4D E3 1D A8 54 AA
  202.                    CF 44 22 01 73 39 93 48
  203.  
  204.  
  205. HISTORY
  206.  
  207.  1.00 (27.07.95)
  208.  
  209.    First public release
  210.